home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1 Issue 2 / PDCD-1 - Issue 02.iso / _utilities / utilities / 001 / schwoosher / !Help next >
Text File  |  1993-12-25  |  14KB  |  351 lines
  1.  
  2.  
  3.                          'Schwoosher' v1.02
  4.  
  5.                           by Tracy of SICK
  6.  
  7.                         all rights reserved
  8.                 this software copyright ⌐ 1993 SICK
  9.            (Merlin Hughes, Conrad Hughes & Andrew Block)
  10.  
  11.                           25 December 1993
  12.  
  13.                                 -o-
  14.  
  15.   Not for the faint-hearted.
  16.  
  17.   This application is Rhubarbware [TM]; not public domain.  Please
  18.   consult the license near the end of this file.
  19.  
  20.   SICK are the Slightly Intelligent  Crazy Rosebi, and this is the
  21.   documentation  (which, perchance, is much larger than the actual
  22.   program).
  23.  
  24.   Schwoosher turns  your display into  a  Tardis  (larger  on  the
  25.   inside than on the  outside).  I  never use  it, it  gives  me a
  26.   headache.  That's hangovers for you I guess.
  27.  
  28.                                 -o-
  29.  
  30.   Erm, I'll keep this quick.  Honest.
  31.  
  32.   With this program,  you can create your own modes which have the
  33.   unique property that their appearance belies  their actual size.
  34.   Basically, you see a  window  into a  screen  which is  actually
  35.   about twice that height.  You can pan about this screen with the
  36.   mouse and keyboard.
  37.  
  38.   Pre-supplied is a module  Schw_127;  if  you run this and change
  39.   into mode 127 (and  mode  127  is  not  already defined  on your
  40.   system) you will get what looks like mode 12.
  41.  
  42. . Moving the mouse up and down pans about your view of the screen.
  43.  
  44. . Right-Alt-Up-Arrow and Right-Alt-Down-Arrow similarly  pan about
  45.   your view of the screen.
  46.  
  47. . Right-Alt-Left-Arrow and Right-Alt-Right-Arrow control the mouse
  48.   'binding'.
  49.  
  50.                                 -o-
  51.  
  52.   The  mouse  binding  controls  how the  window  reacts to  mouse
  53.   movement.  Basically, there are three types:
  54.  
  55. . Type 0 - window is directly  related to vertical position of the
  56.   pointer.
  57.  
  58. . Type 1 - window scrolls as the pointer pushes the top or bottom.
  59.  
  60. . Type 2 - window is totally unrelated to pointer position.
  61.  
  62.   Right-Alt-Left&Right-Arrow  simply  increment  or  decrement the
  63.   current  binding-type,  so  hitting  Right-Alt-Right-Arrow  will
  64.   change mode 127 so that the screen only scrolls when the pointer
  65.   pushes the top or bottom.
  66.  
  67.                                 -o-
  68.  
  69.   To define your own mode,  load the source into an  editor.  Look
  70.   down   a   few   lines   and   you   may    see   the    command
  71.   'PROCinit(12,8,16,127,0)'.  This controls what Schwooshy mode is
  72.   defined.
  73.  
  74. . The '12' means that the mode is physically based on mode 12, and
  75.   thus the window is exactly the same size as a mode 12 one.
  76.  
  77. . The '8' is the 'lost  pixels'  at the top; you will  notice that
  78.   moving  the mouse  near  the top has no  effect  on  the  window
  79.   position.  Reduce this to zero, and there is  no such  region at
  80.   the top; increase it, and the region grows.
  81.  
  82. . The '16' is the 'lost pixels'  at the bottom.  This is useful as
  83.   it lets you see  all of  the icon bar before the pointer reaches
  84.   the absolute bottom of the screen.
  85.  
  86. . The  '127'  is the  mode number which  the  Schwooshy mode  will
  87.   occupy; this must not be already in use.
  88.  
  89. . The '0' is the default mouse binding.
  90.  
  91.   When  you  run the source,  after  editing  the  values  to suit
  92.   yourself, a module called 'Schw_<n>' is  saved, where <n> is the
  93.   mode   occupied   by   the   Schwooshy  mode.  The   module   is
  94.   automatically  loaded.  Whenever  you  load  the   module,   the
  95.   Schwooshy  mode  magically   becomes  available.  You  can  have
  96.   several Schwooshy modes defined if you wish.
  97.  
  98.   Note: Things will get confused  if you are in a particular mode,
  99.   and you then redefine it (or load it again).
  100.  
  101.                                 -o-
  102.  
  103.   Some modes cannot have Schwooshy doppelgangers created.
  104.  
  105.   This can be  because the resulting  mode  would use up  too much
  106.   memory  (480K limit); if the limit is  only just being exceeded,
  107.   try  increasing  the  'lost  pixel'  regions.  (For example,  my
  108.   Schwooshy  version  of  mode   102  requires  48  'lost  pixels'
  109.   altogether).
  110.  
  111.   Alternatively, the mode may be an unusual width, i.e.  each line
  112.   is not a  multiple of 16 bytes;  in such  a  case the Schwoosher
  113.   cannot scroll correctly, so will not create the mode.
  114.  
  115.   If a module is created,  but the mode does  not function, either
  116.   you already have  a mode of that  number in your machine, or you
  117.   are activating an undocumented feature of this program.  Mail me
  118.   your mode and I'll contemplate the universe for a while.
  119.  
  120.                                 -o-
  121.  
  122.   Vaguely technical information; the modes use up twice the memory
  123.   of the base modes,  however do not slow the machine  down beyond
  124.   the fact that  a lot more  area has to be redrawn.  The operaton
  125.   of the pointer is  performed by unlinking it from the mouse, and
  126.   positioning  it every  frame-sync.  The modes  are  created with
  127.   more logical lines than physical lines.
  128.  
  129.   To  change the dependancy upon  Right-Alt, you  must  change the
  130.   internal key number referred to in the source.
  131.  
  132.   This probably won't work with fancy colour-cards.
  133.  
  134.                                 -o-
  135.  
  136.   Known problems:
  137.  
  138. . If  you  are  in the Wimp  in  a Schwooshy  mode  and  you do  a
  139.   soft-reset,  the machine gets confused.  This doesn't happen  if
  140.   you  don't use the Wimp and I don't  think happens under RISC OS
  141.   2.  Oh well.
  142.  
  143.                                 -o-
  144.  
  145.   To do:
  146.  
  147. . Just one module defining lots of Schwooshy modes.
  148.  
  149. . Have less fun next Christmas day 8).
  150.  
  151.                                 -o-
  152.  
  153.                           Rhubarbware [TM]
  154.  
  155.             Rhubarbware is a non-registered trademark of
  156.  
  157.                the Slightly Intelligent Crazy Rosebi
  158.                   and Fluffy Rhubarb Incorporated
  159.                               (honest)
  160.  
  161.  
  162.   This software is RhubarbWare, not Public Domain, so  please read
  163.   the following license carefully.
  164.  
  165.   What does RhubarbWare entail?
  166.  
  167.   RhubarbWare  is licensed for free non-commercial  public use and
  168.   distribution, provided *ALL*  files are included and *NO* profit
  169.   is made from  it.  This means you can't  charge for it or bundle
  170.   it with  another product, without express written permission  of
  171.   the author.
  172.  
  173.   Public domain libraries and such institutions may charge NO MORE
  174.   THAN ú1.00 for distribution on a  medium as  cheap  as a  double
  175.   density disk, and NO MORE THAN ú2.00 on a more expensive  medium
  176.   such as a high  density disk.  This limit includes all  charges;
  177.   post,  packaging,  and copying, and  applies  before any special
  178.   discounts.  It  may  NOT be distributed  along  with  any  other
  179.   product which incurs a greater charge -  such as  a big magazine
  180.   or more expensive disk - without my prior consent.
  181.  
  182.   NO OTHER CHARGES MAY BE MADE.  If in doubt, try  and contact me.
  183.   What  with  my current  lack  of fixed abode,  try electronic in
  184.   preference to solid means.
  185.  
  186.   Should some person or company be found to be in breach of any of
  187.   these conditions, I'll be mondo annoyed.
  188.  
  189.   NO part of any RhubarbWare may be distributed after modification
  190.   without the author's express written permission.
  191.  
  192.   This product is supplied as is; there is no warranty for it.  No
  193.   warranty,  expressed or implied,  including but not limited  to,
  194.   the implied warranties of  merchantability  and  fitness  for  a
  195.   particular purpose, will be  considered valid.  The entire  risk
  196.   as to  the quality  and performance of the  program is with you.
  197.   You assume any  costs  that  may  emerge  as  a  result of  this
  198.   product, it's  use, misuse,  abuse, or  as a result of any other
  199.   phenomenon associated  it.  If in doubt,  blame the pixies.  Not
  200.   the nice little  ones  that  sit  around on  toadstools  playing
  201.   whistles; no,  the nasty evil malevolent pixies;  the tiny green
  202.   ones with black pointy beards, who  invade our computer systems,
  203.   casting their wicked spells and causing all of our problems.
  204.  
  205.   In no event will the copyright holders, or any other parties who
  206.   distribute this product, be liable to you for damages, including
  207.   any  general,  special,   incidental  or  consequential  damages
  208.   arising  out  of the  use  of or inability to  use this  product
  209.   (including,  but not  limited to, loss of data,  or  data  being
  210.   rendered  inaccurate,  or  losses  sustained  by  you  or  third
  211.   parties, or a  failure of the program to  operate with any other
  212.   programs).
  213.  
  214.   If you like this software,  find it useful, or use it regularly,
  215.   you  might like to think  about  registering  your copy with the
  216.   author.  This will  help  to promote further  ventures into this
  217.   and  other   exciting  fields  of   programming   and   culinary
  218.   development.
  219.  
  220.   To  register,  you must  send  the author  either  one stick  of
  221.   rhubarb [rheum palmatum] [rhabarb],  or its  equivalent in  some
  222.   representative medium.
  223.  
  224.   Rhubarb is a very delicate plant, so please treat it  with great
  225.   care  and  respect.  Don't do  anything  insensitive to it, like
  226.   posting  it  and all.  It  would be advisable to wrap any actual
  227.   specimens  of  it  up  in  a  copy of your  favourite recipe for
  228.   rhubarb pie, scribbled on the back of a ten  pound  note, or its
  229.   equivalent in your local  currency.  Please however, be aware of
  230.   any  regional  export  regulations  governing  the  export   and
  231.   transport of  this and  other  agricultural produce.  The author
  232.   will accept no responsibility for individual or group  ignorance
  233.   of any such  laws, which may or may not lead  to any punitive or
  234.   non-punitive measures,  including, but  not limited  to,  fines,
  235.   imprisonment, flogging, or even execution.
  236.  
  237.   The  equivalent  of one stick  of rhubarb in some representative
  238.   medium is defined as a picture, or any other representation of a
  239.   stick of  rhubarb, possibly including the  leaf, on some  medium
  240.   that  is  readable  with  current  technology.  For  example,  a
  241.   scribble on the back of  a postcard of your local region or city
  242.   could be  correctly classified as the equivalent of  a  stick of
  243.   rhubarb in some representative medium.
  244.  
  245.   RhubarbWare is  perfect.  Any unusual features  are  deliberate,
  246.   and definitely have some purpose.  Whether the author knows  the
  247.   purpose  is irrelevant.  Should you  wish  to tell the author of
  248.   any features  they  have  put  in,  or  any additions  you  feel
  249.   necessary,  feel  free to  express  your  opinion.  Please  note
  250.   however,  that  any  useful or  logical features  or alterations
  251.   already  exist.  Whether the author  has included the ability to
  252.   access these features or alterations is not pertinent.
  253.  
  254.   If you  do not  find  this software useful, or  find some  other
  255.   problem with reality,  please feel  free to notify the author of
  256.   your  reasons  for  feeling this way.  If  you include  proof of
  257.   affiliation with the Campaign to Stamp Out the Evil Pixies,  you
  258.   may find the author more agreeable.
  259.  
  260.   The author  may or may not reply  to any correspondence, and may
  261.   even take relevant action, provided it does not directly lead to
  262.   injury  to any  persons, alive,  dead, or fictional.  Unless, of
  263.   course, they are hippos or evil nasty wicked malevolent pixies.
  264.  
  265.   Any  software, ideas, or  suggestions,  are always  appreciated.
  266.   PLEASE, NO LAMERS OR COPIERS.  If you have some great commercial
  267.   software to share, THE AUTHOR DOES NOT WANT TO KNOW.
  268.  
  269.   In any correspondence, where relevant, please include details of
  270.   what hardware and software you are running, your marital status,
  271.   and  what machine you use  (along  with any  relevant associated
  272.   information, for example height, eye colour, etc).
  273.  
  274.   Please adhere to all  recommendations and requisites within this
  275.   license.  If  you support  RhubarbWare  properly,  you  will  be
  276.   encouraging  further pursuit of the RhubarbWare ideal.  You will
  277.   thus directly  be improving  the entire world;  encouraging more
  278.   and  better,  software, promoting  a  cleaner  environment,  and
  279.   generally making better rhubarb pies all around.
  280.  
  281.                                 -o-
  282.  
  283.   If you think  you have an evil pixie in your system, try baiting
  284.   him  with  a   gingerbread  trap.  Some  wicked   goblinry   are
  285.   invisible;  these are particularly difficut to  identify.  Watch
  286.   out for their distinctive markings and large ears.
  287.  
  288.                                 -o-
  289.  
  290.   Basically, feel free  to  copy and distribute this software; you
  291.   may charge  no more than ú1.00 altogether if you distribute on a
  292.   double  density disk.  If you want  to charge more, delete  this
  293.   application; I don't write for the enrichment of other companies
  294.   and individuals.
  295.  
  296.   Remember, I don't profit from this; why should you?
  297.  
  298.   Write to me if you wish; however I may not have time to reply.
  299.  
  300.                                 -o-
  301.  
  302.   After August  1994, you may have to find out a new  address; for
  303.   the year however, you can catch me as follows.
  304.  
  305.   Address:                     SICK,
  306.                        Dept Lucid Fairytale,
  307.                               Flat 1,
  308.                         14 Palmerston Park,
  309.                              Dublin 6,
  310.                                Eire.
  311.  
  312.   Phone:                   +353-1-974900
  313.  
  314.   This  should be prefixed  by your country's international access
  315.   code; ie 010-353-1-974900
  316.  
  317.   My e-mail addresses will last for a while.  Well, a year.
  318.  
  319.   Internet:             merlin@maths.tcd.ie
  320.                        mhughes@scrg.cs.tcd.ie
  321.                         chughes@maths.tcd.ie
  322.                        hughesmp@unix1.tcd.ie
  323.                         hughesmp@vax1.tcd.ie
  324.  
  325.   Contact me through my mum at:
  326.  
  327.   Address:                 Merlin Hughes,
  328.                         14 Kenilworth Park,
  329.                           Harold's Cross,
  330.                              Dublin 6W,
  331.                                Eire.
  332.  
  333.   Phone:                   +353-1-901237
  334.  
  335.                                 -o-
  336.  
  337.   If rhubarb does not lie within your vegetable garden,  dig it up
  338.   from  an encyclopaedia, or failing  that,  replace  it  with  an
  339.   alternative known plant life, for example, a kiwi fruit.
  340.  
  341.                                 -o-
  342.  
  343.   This release of  Schwoosher is  dedicated to  Bulmers cider.  WE
  344.                   maek a lichle dhrichingk.  Hcik.
  345.  
  346.                           Happy Christmas
  347.  
  348.                               Merlin.
  349.  
  350.                                 -o-
  351.